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1.0 INTRODUCTION 

DTELDR is a communications utility program used to load programs from 
the TOPS-10 file system into a front end, and to dump front-end memory 
into a file on disk. DTELDR loads and dumps through the DTE20 (Data 
Ten-to-Eleven interface) . This program runs in user mode under normal 
timesharing; its user must be logged in as [1,2], and have TRPSET and 
LOCK privileges. To use DTELDR, the TOPS-10 monitor must have been 
assembled with MSGSER. 



2.0 COMMAND FORMAT 

The format for commands to DTELDR is: 

dev: filename .ext [p,pn, SFD, SFD, ...] /switch/switch. . . 
where all entries except /switch are optional. 



3.0 FILE SPECIFICATIONS 

The default name for a file to load into the PDP-11 front end is: 

DSK: DTELxy.BIN 

where x = CPU number (0 to (n-1) , where n is the number of CPUs in 
your system) 
y = DTE number (0 to 3) . 

The file on which a dump is written is called: 

DSK: DTEDxy.BIN 

where x and y are as defined above. 

Once the DTEDxy.BIN file exists, new generations .BOO, .BOl, . . . ,B99 are 
created automatically. 

There are three allowable formats for files loaded or dumped by 
DTELDR, packed mode, image mode and diagnostics mode. Packed mode 
(typically generated by MACYll/P for a PDP-11) is as follows: 

Bits 



Contents 






1 






18 


19 






35 








8-bit byte 

#2 


8-bit byte 

#1 








8-bit byte 

#4 


8-bit byte 

#3 



Half-word 1 Half-word 2 

Figure 1 Packed Mode .BIN Format 
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Image mode is as follows 



Bits 



Contents 






1 






18 


19 




24 


35 























8-bit byte 
#1 



Figure 2 Image Mode Format 
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Bytes are stored one byte/word as follows: 

Bits 28 29 30 31 32 33 34 35 

Contents 



function 



data 



Function Bits: Indicate that the Data Bits Contain: 

00 Data or checksum 

01 Starting address for loading memory 

10 Leader 

1 1 Memory field (for extended addressing) 

MR-S-899-80 

Figure 3 Eight-Bit Image-Mode Byte 



Diagnostics mode format is as follows 



E 
or 


Space 


= start block 
PI 


!|8i; 


Address of 
location in 
PDP-11 T1 


Hi 


Checksum 






E 

or 


Space 


word count of 
data words PI 


llil 


Address of 

location in 

PDP-11 


IK 


Data 




Data 





1 6 bits 

specifies end of word: a character less than ASCII octal 75 
data blocks can be up to four characters long 
the word count specifies the number of data words only 
the checksum must be zero or an error message is returned 
; specifies comment 

Figure 4 .All Diagnostics Format 



Check- 
sum 


CR 
LF 
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4 . DTELDR SWITCHES 

DTELDR switches fall into two groups: those that initiate action such 
as loading or dumping, and those that modify action switches. 
Switches are listed below in the two groups. Switches in brackets [] 
are modification switches that can optionally be used with the switch 
specified . 

Action switches are: 

/ASWITCH 

/AUTOMATIC [/DUMP, /IMAGE, /All, /NOLOG, /NODUMP, [/SELECT 

/SWITCH] , /TALK] 
/DDT 

/DUMP [/NOLOG, /IMAGE, /All] 
/EXIT 
/HELP 
/IGNORE 
/INITIALIZE 
/NOLISTEN 

/RELOAD [/NOLOG, /NODUMP, /All] 
/TALK 
/TERMINATE 

Modification switches are: 

/All 

/IMAGE 

/NODUMP 

/NOLOG 

/SELECT /SWITCH 

/SWITCH 

The function of each DTELDR switch is described below (switches are 
listed alphabetically). 



Switch 



/All 



Function 

Specifies that the binary file is in .All format 
encoded by diagnostics (see Section 3.0, "File 
Specifications") . 



/ASWITCH: 
xy: value 



Uses octal value when reloading given front end 
automatically. 



/AUTOMATIC 



Automatically reloads a front end from an implied 
file. The file for the reload is taken from 
SYS:DTELxy .BIN where x, y are as defined above. 
The file must exist or an error message is 
returned . 



/DDT 
/DUMP:xy 



/EXIT 



Enters loaded DDT, returns with CPOPJ$G. 

Dumps specified front end, placing dumped file on 
XPN: DTEDxy.BIN (or later generations .BOO, .BOl, 
etc.). X can be omitted. File extension 
generation numbers are automatically increased to 
the maximum .B99. If an attempt is made to create 
an additional file past this maximum, an error 
message is returned. 

Exits to monitor. 



Switch 

/HELP 

/IGNORE: 
xy :xy : . . . :xy 

/IMAGE 



/INITIALIZErxy 



/NODUMP 



/NOLISTEN: 
xy : xy : . . . : xy 

/NOLOG 



/RELOADrxy 



/SELECT:dev 



Function 

Outputs the DTELDR HELP file. 

In automatic mode, does nothing to the given front 
end . 

Specifies that the .BIN file is in image format. 
The default format for a .BIN file is /PACKED. 

Starts primary protocol on the specified front 
end. The primary protocol is used until the 
DECsystem-10 CPU is reloaded or a /TERMINATE 
command is issued; x and y are as defined above. 

Turns off the /DUMP switch and /RELOAD dump 
activity for dumping the PDP-11. 

Does not listen to CTY of given front end except 
when reloading. 

Turns off the automatic error logging that is 
normally invoked with /RELOAD. 

Takes dump, reloads the specified front end, 
starts primary protocol, and starts error logging. 
Dumps and error logging can be eliminated by using 
the /NODUMP and /NOLOG switches. 

Specifies source device from which to reload the 
front end. 



For 


Dev 


Reloads 




10 


over 


KLIO 


DTE20 


PDP-11 1 


11 





1 With SELECT: 11, the /SWITCH switch must be used and no filespec 
can be given. 



Switch Function 

/SWITCHro Specifies (with an octal value o) the loading 

procedure on the unit that contains the reload 
file. Use this switch with /SELECT. You can use 
DTELDR to load any front end in your system 
connected over a DTE20, by giving the front end 
number with /RELOAD. When you load RSX20F into 
front-end 0, the value you give to /SWITCH 
specifies how KLINIT and primary protocol will be 
used. When you load some other front end, use 
/SELECT and /SWITCH to give the device and unit 
number of the device that contains the reload 
file. Use the octal values given below. Shading 
in Table 1 shows the functional divisions and 
indicates which bits are being described under 
"Meaning. " 
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Table 1 
Octal Value to use with /SWITCH 



Switch Enable 
Load Select 



Line Speed 
Boot Device 
DHll or Boot Unit 
Console Line No. 
Retry 



\ . 



Switches/Bits 
Octal Value 

000001 
000005 

000007 
000001 



000001 
100001 

000001 



000 000 000 000 000 



000 000 000 000 000 001 



17 1615 14 13 12 11 10 9 8 7 6 5 4 3 2 10 
Binary Equivalent 



000 000 000 000 000 00 







000 000 000 000 000 1 ;g 1 



1:1: 



000001 
000201 












































































































'0; 
























































































000201 















000601 


i) 





/I 
















001201 





1 





















001601 





1 


t 














002201 


1 
























002601 


1 





1 


















003201 


1 


1 


iO 


















003601 


■:1^ 


1 


1 




















000001 











vO 








of¥] 000 000 000 000 001 
oil] 000 000 000 000 001 



Meaning 

Do a complete reload, as specified by bits 
1 to 17 below. Bits 1 and 2 must be zero 
torunCHKll. 

Load RSX20F without communicating 
with the central processor. KLIO is as- 
sumed up. This reloads and starts the 
-11, does not use KLINIT. 

Load RSX20F, load and start KLINIT di- 
alog to control loading. 

To u!3e software implementations of con- 
sole speed and fill class, set these bits to 
zero. To use these bits to specify a physi- 
cal line for the CTY, give the line speed 
with these bits (from Table 2), give the 
DHll unit number in bits 10 to 8, and 
give the hardware line number within 
the DHll in bits 14 to 11. You can also 
use these bits to give the line speed for a 
DLll line specified in bits 14 to 11. 

Use as available, floppy (for 1091) or 
DECtape (for all but 1091). 

Use disk unit selected in bits 10 to 8. 

Use unit as the boot device. 

Use unit 1 as the boot device. 

Use unit 2 as the boot device. 

Use unit 3 as the boot device. 

Use unit 4 as the boot device. 

Use unit 5 as the boot device. 

Use unit 6 as the boot device. 

Use unit 7 as the boot device. 

For software implementations of console 
line number (as for RSX20F and 
TOPS-10) these bits must always be 
zero. These bits can also give a line num- 
ber for the CTY. To do so, set the line 
speed with bits 6 to 3, above, and give 
the DHll unit number in bits 10 to 8. 

Retry 10 times when an I/O error occurs 
during booting. 

Retry indefinitely when an I/O error oc- 
curs during booting. Abort with manual 
intervention. 



fl 000 000 000 000 001 Always zero. 
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Table 2 
Speed Table (Bits 6 to 3) 



Octal 




Bits 




Baud 


Value 


6 


5 


4 


3 


Rate 

















zero 


1 











1 


50 


2 













75 


3 










1 


110 


4 





1 








134.5 


5 





1 




1 


150 


6 





1 







200 


7 





1 




1 


300 


10 












600 


11 









1 


1200 


12 












1800 


13 









1 


2400 


14 




1 








4800 


15 




1 





1 


9600 
MR-S-1 694-81 



NOTE 

These switches can be used together in 
combination. To combine functions, 
first form the binary value, then derive 
the octal value to use with /SWITCH. 



Switch 



Function 



/TALK: 
xy.xy: . . . :xy 



Talk to the CTY of the given front ends 
/TERMINATEixy Shuts down the specified front end. 



5.0 RUNNING DTELDR 

To run DTELDR, you must be logged in as [1,2], have the appropriate 
TRPSET and LOCK privileges, and have a file containing the appropriate 
.BIN software. You can then enter: 

.R DTELDR 

The program prompts for input with a star (*): 



Enter the file specification and the necessary switches. For example, 
to load a DN87S over DTE20 number 2 from DSK: DN8721 . BIN and suppress 
automatic dumping, respond as follows: 

DN8721. BIN/RELOAD :2/N0DUMP 

Once loading is complete and the -11 tells the -10 that its 
initialization is complete, primary protocol starts and the star (*) 
prompt reappears. 



For automatic execution of DTELDR, the appropriate 
normally put in the OPR.ATO file to be run by OPSER. 



commands are 



For example, the following sequence of commands placed in the OPR.ATO 
file provides for both the automatic loading of a front end at system 
initialization time, and for subsequent automatic reloading if the 
front end crashes. 



:SLOG 
:DEF DTE= 
DTE-R DTELDR 
DTE-/RELOAD: 2/NODUMP 

DTE-/AUTO 



log in a subjob 

call it DTE 

load and start DTELDR 

load over DTE20 number 2, suppress 

automatic dumping 

do automatic reload (the default file 

called DTEL02.BIN that is to be loaded 

must exist on SYS:) 



6.0 ERROR MESSAGES 

Messages output by DTELDR occur because of hardware, software, or user 
error . 



Message 
All retries failed 

Ambiguous switch--type /H for help 
Bad All format 

Cannot specify both /All and /IMAGE 



Cause and Corrective Action 

Hardware - verify 
configuration or call Field 
Service. 

User - reenter command. 

Software or user - input file 
is wrong. Use another file. 

User - reenter command. 



Cannot specify filespec if /SELECT: 11 User - reenter command, 
used 



Cannot use /AUTOMATIC with /RELOAD 



User - reenter command. 



Message 
Cannot use /INITIALIZE with /RELOAD 
Cannot use /TERMINATE with /RELOAD 
Can't OPEN the input device 

Can't OPEN the output device 

Checksum failure 

Command error--type /H for help 

DAEMON CALL failure, no entry made 
in ERROR. SYS 

DATA Checksum failure 

DTE number too large 

DTE. UUO failed to set reload job 

ENTER failed 

EOF after file constant 1 
EOF at start of file group 
EOF during data in file group 
EOF during first byte of a word 
EOF during second byte of a word 
EOF found when looking for checksum 
ERROR CODE FROM DTE. UUO 



ERROR CODE — DTE. UUO 
IMPLEMENTED IN THIS MONITOR 



NOT 



ERROR CODE 1 — MUST HAVE PRIVILEGES 
TO RUN DTELDR 

ERROR CODE 2 — INTERNAL ERROR - 
DTE. UUO CALLED WITH BAD FUNCTION 
NUMBER 

ERROR CODE 3 — BAD FRONT END 
NUMBER 

ERROR CODE 4 — PRIMARY PROTOCOL 
STILL RUNNING 



Cause and Corrective Action 

User - reenter command. 

User - reenter command. 

Software or user - reenter 
command . 

Software or user - reenter 
command . 

Hardware - call Field Service. 

User - reenter command. 

Hardware - call Field Service. 

Hardware - call Field Service. 

User - reenter command. 

Hardware - call Field Service. 

Hardware or user - try again. 
You may not have the right 
privileges to run DTELDR. 

Software - use another file. 

Software - use another file. 

Software - use another file. 

Software - use another file. 

Software - use another file. 

Software - use another file. 

Hardware or user - call Field 
Service . 

Software - you cannot use 

DTELDR. You must obtain a 
monitor that supports 
networks . 

User - obtain operator 
privileges to run DTELDR. 

Hardware - call Field Service. 



User - reenter command 



Hardware - call Field Service 



Message 



Cause and Corrective Action 



ERROR CODE 5 — -11 POWER FAIL DID 
NOT SET 

ERROR CODE 6 — -11 ROM PROGRAM 
FAILED TO START - CHECK HALT 
SWITCH 

ERROR CODE 7 — TO-10 ERROR DURING 
BOOTSTRAP SEQUENCE 

ERROR CODE 10 — -11 OBJECT PROGRAM 
FAILED TO SEND TO-10 DOORBELL 

ERROR CODE 11 — INTERNAL ERROR - BAD 
JOB NUMBER GIVEN TO DTE. UUO 

ERROR CODE 12 — BAD ERROR CODE FROM 
DTE. UUO 

ERROR CODE 13 — BAD ERROR CODE FROM 
DTE . UUO 

ERROR CODE 14 — BAD ERROR CODE FROM 
DTE. UUO 

ERROR CODE 15 — BAD ERROR CODE FROM 
DTE. UUO 

ERROR CODE 16 — BAD ERROR CODE FROM 
DTE. UUO 

ERROR CODE 17 — FAILED TO START 
PRIMARY PROTOCOL 

ERROR DURING BOOTSTRAP SEQUENCE 

ERROR DURING DUMP 

ERROR - BAD JOB NUMBER GIVEN TO DTE. 
UUO 

ERROR - DTE. UUO CALLED WITH BAD 
FUNCTION NUMBER 

error after To-11 byte transfer 

error for dump file 

error while dumping 

error--type /H for help 

File group byte count less than 6 

File group has junk instead of 
constant n 

File zero byte count -- trying again 
in /IMAGE mode 



Hardware - call Field Service 



Hardware - check and reset 
HALT switch or call Field 
Service . 

Hardware - call Field Service. 



Hardware - call Field Service 

Hardware - call Field Service, 

Hardware - call Field Service, 

Hardware - call Field Service, 

Hardware - call Field Service, 

Hardware - call Field Service, 

Hardware - call Field Service, 

Hardware - call Field Service. 

Hardware - call Field Service. 
Hardware - call Field Service. 
Hardware - call Field Service, 

Hardware - call Field Service. 

Hardware - call Field Service. 
Hardware - call Field Service. 
Hardware - call Field Service. 
User - reenter command. 
Hardware - call Field Service. 
Hardware - call Field Service. 



Hardware, software, or user - 
either use another file, 
reenter your command, or call 
Field Service. 



Message 
HIBER failure 

Illegal address for /START 

Illegal switch or switches used with 
/TERMINATE 

Illegal switch or switches used with 
/INITIALIZE 

Input file read error 

Junk after start group 
Junk bits in input file 



Junk in input file--may not be /IMAGE 
mode 

LOCK failure m 



LOCKUP failed 

Must specify address for /START 

Must specify either 10 or 11 for 
/SELECT 

Must specify front end in /RELOAD 

Must specify front end in /TERMINATE 

Must specify front end number for 
/INITIALIZE 

Must specify switch value 

Only legal values for /SELECT are 10, 
11 

Output error for dump file 

Reload source is -10, /SWITCH ignored 

START BLOCK Checksum failure 

STRING OUTPUT TO OPR FAILED 

Timeout waiting for 11 program to 
start 



Cause and Corrective Action 

Hardware or software - use 
another file or call Field 
Service. 

User - reenter command. 

User - reenter command. 

User - reenter command. 

Hardware or user - reenter 
command, use another file or 
call Field Service. 

Hardware - call Field Service. 

Hardware or software - use 
another file or call Field 
Service. 

User or software - use another 
file or reenter command. 

System software - verify 
privileges . 

System software - verify 
privileges . 

User - reenter command. 

User - reenter command. 

User - reenter command. 
User - reenter command. 
User - reenter command. 

User - reenter command. 
User - reenter command. 

Hardware - call Field Service. 

User - no action needed. 

Hardware - call Field Service. 

Hardware or software. 

Hardware or software - try 
again . 



Message 

Timeout while doing To-11 byte 
transfer 

Timeout while waiting for dump 
transfer to complete 

To-10 error while dumping 

To-11 error after To-11 byte transfer 

TRPSET failed 

UNKNOWN DTE. ERROR CODE 
Unexpected EOF 



Unknown switch--type /H for help 

Value for /SWITCH must not exceed 
177777 



Cause and Corrective Action 
Hardware - call Field Service. 

Hardware - call Field Service. 

Hardware - call Field Service. 
Hardware - call Field Service. 



Software 
pr ivileges . 



verify your 



Hardware - call Field Service. 

Hardware or software - call 
Field Service or use another 
file. 

User - reenter command. 

User - reenter command. 
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